<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>MixerSetLevel_i</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
    <link rel="prev" href="MixerSetLevel.html" title="MixerSetLevel" />
    <link rel="next" href="MixerGetLevel.html" title="MixerGetLevel" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">MixerSetLevel_i</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="MixerSetLevel.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="MixerGetLevel.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="MixerSetLevel_i"></a>
      <div class="titlepage"></div>
      <a id="IndexMixerSetLevel_i" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">MixerSetLevel_i</span>
        </h2>
        <p>MixerSetLevel_i — 
      Sets the level of a send to a buss.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp125720416"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>MixerSetLevel_i</strong></span> isend, ibuss, igain</pre>
      </div>
      <div class="refsect1">
        <a id="idp125722304"></a>
        <h2>Description</h2>
        <p>Sets the level at which signals from the send are added to the buss. This opcode, because all parameters are irate, may 
      be used in the orchestra header. The actual sending of the signal to the buss 
      is performed by the <a class="link" href="MixerSend.html" title="MixerSend"><em class="citetitle">MixerSend</em></a> opcode. 
    </p>
      </div>
      <div class="refsect1">
        <a id="idp125724608"></a>
        <h2>Initialization</h2>
        <p><span class="emphasis"><em>isend</em></span> -- The number of the send, for example the number of the instrument sending the signal (but any integer can be used).</p>
        <p><span class="emphasis"><em>ibuss</em></span> -- The number of the buss, for example the number of the instrument receiving the signal (but any integer can be used).</p>
        <p><span class="emphasis"><em>igain</em></span> -- The level (any real number) at which the signal from the send will be mixed onto the buss. The default is 0.</p>
        <p>Setting the gain for a buss also creates the buss.</p>
      </div>
      <div class="refsect1">
        <a id="idp125728272"></a>
        <h2>Performance</h2>
        <p>
      Use of the mixer requires that instruments setting gains have smaller numbers than instruments sending signals, 
      and that instruments sending signals have smaller numbers than instruments receiving those signals. 
      However, an instrument may have any number of sends or receives. After the final signal is received, 
      <a class="link" href="MixerClear.html" title="MixerClear"><em class="citetitle">MixerClear</em></a> must be invoked to reset the busses before the next kperiod.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp125730736"></a>
        <h2>Examples</h2>
        <p>In the orchestra header, set the gain for the send from buss 3 to buss 4:</p>
        <pre class="programlisting">
      <span class="opc">MixerSetLevel_i</span>		3, 4, 0.76</pre>
      </div>
      <div class="refsect1">
        <a id="idp125733360"></a>
        <h2>Credits</h2>
        <p>Michael Gogins (gogins at pipeline dot com).</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="MixerSetLevel.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="OpcodesTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="MixerGetLevel.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">MixerSetLevel </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> MixerGetLevel</td>
        </tr>
      </table>
    </div>
  </body>
</html>
